home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / satellit / display / display.doc next >
Text File  |  1991-10-22  |  10KB  |  328 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                       D I S P L A Y 4 . E X E
  8.  
  9.  
  10.                        O C T O B E R  1 9 9 1
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.          FOR THE DISPLAY OF UOSAT OSCAR 22 CCD PICTURE FILES
  18.  
  19.  
  20.  
  21.         Free Issue Software for Licensed Amateur Radio Use ONLY.
  22.  
  23.  
  24.                  Copyright 1991  AMSAT-Australia
  25.  
  26.  
  27.  
  28.  
  29.  
  30.           Donations in appreciation of this software package
  31.  
  32.                   to assist fund and develop future 
  33.  
  34.                   Amateur Radio Satellite Programs
  35.  
  36.                        may be forwarded to
  37.  
  38.                          AMSAT AUSTRALIA
  39.  
  40.                           GPO BOX 2141
  41.  
  42.                             ADELAIDE
  43.  
  44.                          SOUTH AUSTRALIA 
  45.  
  46.                           AUSTRALIA 5001
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. This document is to cover the program DISPLAY4.EXE Version 4.1 
  71. released 6th October 1991.
  72.  
  73. Version 4.1 is a significant update of all the previous versions of 
  74. DISPLAY.EXE with additional enhancements.
  75.  
  76. Updates from Version 4.0 include :
  77.  
  78.             1. Ability to read .DLX or .ACT files
  79.  
  80.             2. Recognisation of "non standard" files.
  81.  
  82.             3. Automatic calculation of the exposure time
  83.  
  84.             4. Deletion of Auto white bar fill
  85.  
  86.             5. Inclusion of Manual white bar fill
  87.  
  88.             6. Automatic exposure correction of displayed file
  89.  
  90.             7. General enhancement of Display Screen
  91.  
  92.             8. Eraseable scroll bar to highlight scroll update
  93.  
  94. FILE CAPABILITY.
  95.  
  96.     DISPLAY4.EXE is designed to display retrieved CCD or IM Series 
  97. Picture Files. However after specific requests from users of 
  98. previous versions of DISPLAY to have the ability of displaying .ACT 
  99. files, I have included that ability. For best display performance 
  100. the .ACT file should have the minimum number of holes. However it is 
  101. extremely usefull even with only 25% of the total, in being able to 
  102. preview the picture with a view towards completing or abandoning the 
  103. file. The only limitation on .ACT or .DLX files is that are of the 
  104. IM Series, ie: Files 0x0224 and above. The program will work with 
  105. earlier files however the picture will be misaligned, but viewable.
  106. Having released Version 4.0, the very next day IM0019 was obtained 
  107. and when loaded indicated it was corrupted. In Version 4.1 I have 
  108. revised the rules by which a file is recognised to be "corrupt".
  109. The format of the IM Series file makes it extremely difficult to 
  110. retrieve should it be corrupt. Therefore I have relaxed the test on 
  111. both the CCD and IM Series, and issue an appropriate message. The 
  112. penalty is of course that corrupt CCD files cannot be written back 
  113. as an uncorrupted file. However should this be the case the use of 
  114. DISPLAY2.EXE will overcome this problem.
  115.  
  116. DETERMINATION OF EXPOSURE TIME
  117.  
  118.     As the file commences to load into memory the program 
  119. interrogates the file header information and calculates the exposure 
  120. time from the UNIX Time Stamp embedded in the header. This timestamp 
  121. is also wriiten to the file display, once the file is loaded.
  122. However while the file is loading, you should record the date and 
  123. time displayed so that at a later time you can use your Tracking 
  124. Program (eg:InstantTrack) to ascertain where the picture was taken. 
  125. Make certain that you include the seconds value, because 1 minute on 
  126. UoSat Oscar 22 is a significant distance. Having determined the 
  127. location you will generally require an atlas, and the use of the F5, 
  128. F6, F7 and F8 keys to achieve the correct picture orientation, 
  129. unless the picture is of a notably distinguishable landmark.
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. WHITE BAR FILL.
  137.  
  138.     The automatic white bar rejector in Version 4.0, did not meet my 
  139. personal expectations. I in fact experimented with 4 diferent 
  140. functions before settling for a manual solution.
  141. Whilst in the EDIT mode you use the PAGEUP or PAGEDOWN keys.
  142. The PAGEUP Key darkens the bar by 0x01 bytes per key stroke, 
  143. whereas the PAGEDOWN whitens by 0x01 bytes. You may require at least 
  144. 10 key strokes to note a visible darkening in some instances. 
  145. Experience will assist you to ascertain the correct balance. On the 
  146. pictures retrieved to date it is extremely difficult to obtain an 
  147. ideal match. [Also refer the INSERT and DELETE Key Functions].
  148.  
  149. MEAN VALUE AUTOMATIC EXPOSURE CORRECTION.
  150.  
  151.     As stated in previous notes, I unfortunately managed to include 
  152. a "bug" in the original versions of Display. It was not until the IM 
  153. Series appeared that I realised that there was a problem. (The 
  154. symptom was all those "washed out" white pictures). The paradoxial 
  155. situation was that the "bug" in fact enhanced the CCD Series of 
  156. pictures. However now is all resolved. Currently the Surrey Team are 
  157. experimenting with exposure settings,etc. Consequently the pictures 
  158. can vary from "overexposed through underexposed". In version 4.0 
  159. this required considerable patience to adjust the contrast manually. 
  160. Now as the file is being loaded a MEAN VALUE calculation, is 
  161. performed on all the picture bytes. Theoretically within a 64 Grey 
  162. Scale Picture the mean value of the picture should be 0x1f, being 
  163. the mean value of 0x00(black) and 0x3f(white). Once the MEAN VALUE 
  164. is ascertained all the picture bytes are adjusted to achieve a 
  165. displayed mean of 0x1f. [For example load IM001A, CCD2(14th Aug), 
  166. IM0011 and IM0018 and compare the MEANS.]
  167. NOTE! If the exposure contains excessive whites or blacks this 
  168. algorithm fails - however this rarely occurs, and should become a 
  169. lesser problem as the Surrey Team gain greater experience.
  170. This AUTOMATIC Correction is the DEFAULT setting. Should you wish to 
  171. over-ride this function, enter the NOMEAN [option] on the command 
  172. line.
  173. When the picture is displayed the PICTURE STATUS in the lower left 
  174. of screen, details the calculated mean, and the screen mean value.
  175. In the default setting the screen mean will be displayed as 0x1f.
  176. Should you exercise the NOMEAN Option when initially loaded the 
  177. calculated mean and displayed mean will be of equal value. As the 
  178. display is manually adjusted the Screen value will increase or 
  179. decrease by an amount of +/- 0x04 bytes. 
  180.  
  181. SCREEN ENHANCEMENT
  182.  
  183. Every picture tells a story. In my case every pretty picture tells a 
  184. story, hence the colourisation etc. 
  185. Features include EDIT and DISPLAY Fields (Contrast, Brightness, etc.)
  186.                  PIXEL Information (Blacks, Whites etc.)
  187.                  PICTURE Information (Mean and Screen Mean Values).
  188.                  Scrolling EDIT bar to identify line processing locn.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. KEY FUNCTIONS
  203.  
  204.         KEY           FUNCTION                         EDIT      DISPLAY
  205.  
  206.         F1          Reserved Future Use
  207.  
  208.         F2          Select EDIT Mode                                X
  209.  
  210.         F3          Reserved Future Use                          
  211.  
  212.         F4          Reserved Future Use                        
  213.  
  214.         F5          Normal Display                                  X
  215.  
  216.         F6          Rotate 90 Deg Clockwise                         X
  217.  
  218.         F7          Rotate 180 Deg                                  X
  219.  
  220.         F8          Rotate 270 Deg                                  X
  221.  
  222.         INSERT      Increase Contrast Top to White Bar   X
  223.  
  224.         DELETE      Decrease Contrast Top to White Bar   X
  225.  
  226.     HOME        Default-Top 480 lines (640x480 Display)         X
  227.  
  228.     END        Bottom 480 lines
  229.  
  230.         PAGEUP      Increase Darkness of Bar             X
  231.  
  232.         PAGEDOWN    Increase Whiteness of Bar            X
  233.  
  234.         UP ARROW    Increase Contrast Total Picture      X
  235.  
  236.         DOWN ARROW  Decrease Contrast Total Picture      X
  237.  
  238.         RIGHT ARROW Increase Brightness Total Picture    X          X
  239.  
  240.         LEFT ARROW  Decrease Brightness Total Picture    X          X
  241.  
  242.         ALT-X       Exit Program                         X          X
  243.  
  244. NOTE :
  245.        F5 or F6 or F7 or F8 Key Strokes exits from EDIT to DISPLAY Mode
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. COMMAND LINE
  269.  
  270.     The command line looks for an entry as follows :
  271.  
  272.         DISPLAY4 <filename> [options]
  273.  
  274.         DISPLAY4 -> Displays Help Information
  275.  
  276.                     <filename> expects CCD???? or IM???? 
  277.  
  278.                     <filename> can include path and directory
  279.  
  280.         eg. DISPLAY4 \UO_22\DISPLAY\IM0012
  281.  
  282.         [options] 800 for 800 x 600 Display (default = 640 x 480)
  283.                   
  284.                   nomean to negate automatic picture correction
  285.  
  286.                   view   to view original picture before enhancement
  287.  
  288.         The options may be entered in any order.
  289.  
  290. PICTURE OPTIMISATION.
  291.  
  292.     The following hints may assist you to optimise the various 
  293. pictures retrieved from UO_22. The final result is one of personal 
  294. preference.
  295.  
  296. EDIT MODE
  297.  
  298. Firstly observe whether the contrast of the picture between the top 
  299. of screen and the white bar is the same as below the white bar. Some 
  300. of the pictures obtained have a marked difference in contrast.
  301. Should this be the case use either the INSERT KEY to Darken or the 
  302. DELETE KEY to Whiten. Eack keystroke varies the pixel byte by plus 
  303. or minus 0x01.
  304. Now use the PAGEUP KEY to darken the White Bar. Use PAGEDOWN to 
  305. reverse should you "over-darken". Rarely will you get a perfect 
  306. balance. Once again it is a personal preference.
  307. Once you optimise the bar you may find that you need to re-optimise 
  308. the top section of the picture. (Above the now "non-existent" bar).
  309. With the AUTOMATIC MEAN VALUE correction it is highly unlikely that 
  310. you need to adjust the total picture CONTRAST, unless it is highly 
  311. unbalanced with an excess of whites or blacks. 
  312. Refer the Pixel Indicator.
  313.     The Black Value is Qty of Pixel Bytes <= 0x10
  314.     The White Value is Qty of Pixel Bytes >= 0x30
  315.     The Mid Value is thus Qty of Pixels > 0x10 and < 0x30
  316. To adjust the brightness of the picture use the RIGHT ARROW. Each 
  317. key stroke increases the factor by 20% (displayed as Pixel Factor in 
  318. units of percentage. Base Value is 100%).
  319. Once you have optimised the picture you can select either F5 through 
  320. F8 to place the screen into DISPLAY Mode. The only functions 
  321. available in DISPLAY are rotation and brightness. Should you wish to 
  322. re-adjust the white bar, contrast etc, F2 will place you back into 
  323. EDIT MODE.
  324.  
  325.  
  326. Prepared : Colin VK5HI 6th October 1991
  327.  
  328.